# Window Manager Features and Polish

Date: 2026-10-16. Complements the issue audit in
`docs/window-manager-audit.md`.

## Improvements

| Component | Behavior |
| --- | --- |
| Calendar | A graphical calendar translated by Zenity is available from the applications menu. Repeated clicks do not open multiple windows. Added the dependency to images with desktop-essentials. |
| Clocks | Openbox Tint2, bspwm/Herbstluftwm Polybar, Awesome, Qtile, IceWM, and Waybar clocks open the calendar when clicked. Openbox clock no longer falls back to a calculator because `gsimplecal` is missing. |
| Qtile | Bar has clickable tasks instead of only the window title. Clickable layout selector; Super+Ctrl+Space switches layouts. Super+M minimizes; Super+Shift+M restores minimized windows in the group. Alt+Tab / Alt+Shift+Tab switches windows. Added brightness and microphone-mute keys. |
| Awesome | Alt+Tab / Alt+Shift+Tab changes focus and raises the window. Super+Shift+M restores a minimized window. Layout icon responds to left/right clicks. Added brightness and microphone-mute keys. |
| bspwm / i3 | Alt+Tab opens the Rofi window switcher. |
| Sway | Alt+Tab / Alt+Shift+Tab navigates containers; this is native navigation, not a global switcher. Waybar menu button is labelled Pepvoid. Network and battery open their settings. |
| Locking | Ctrl+Alt+L locks all eight customized X11 WMs and Sway without removing Super+L from Vim-style navigation. Ctrl+Alt+Delete opens the session menu where it was added; existing bindings remain. |
| Polybar | Startup detects real battery and adapter names. Hides the module on machines without a battery and ignores peripheral batteries. Uses personal configuration or XDG fallback, avoids restarting all panels on WM reload, and reloads the file when it changes. |
| Menus | Awesome, Fluxbox, and IceWM have native entries for shares and printers. Shared start menu includes calendar, file search, and disks. Fixed the Disks utility executable in the Openbox menu to `gnome-disks`. |
| Guides | Updated available shortcut guides, including new Qtile actions and actual middle-mouse behavior. |

Enlightenment's native menus and controls remain; the calendar appears in its
applications menu. No binary shortcut/gadget configuration was imposed on
Enlightenment.

## Validation

- Tests for battery/adapter/peripheral detection and concurrent calendar
  launches; checks for actions/widgets and duplicate Qtile shortcuts.
- Native i3, Awesome, and Sway parsers; Herbstluftwm and bspwm configuration
  commands in a private Xvfb session.
- Polybar: verified real module-list expansion with and without a battery for
  both WMs. Environment references occupy the full value as required by the
  parser.
- Openbox/Fluxbox/IceWM: private startup/config-read tests, plus XML and shell
  checks. Qtile: syntax and API review against the available package; no full
  session was started.
- Full pytest suite and validation of the new `.desktop` file.

## Graphical Testing Still Needed

No ISO was generated and no complete session was visually inspected. Test on
real hardware: tasks/minimization, layouts, calendar, keyboard focus,
lock/unlock, brightness/microphone, and power status. Bars still need review
with HiDPI and multiple monitors. The automatically tested battery is
simulated; real devices require hardware.

These changes define defaults for new images/users. Existing personal
configurations may take precedence.